Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Creating Tracks and Media Structures

DisposeTrackMedia

The DisposeTrackMedia function removes a media from a track. This function does not remove the track from its movie.

pascal void DisposeTrackMedia (Media theMedia);

theMedia

Specifies the media for this operation. Your application obtains this media identifier from such Movie Toolbox functions as NewTrackMedia and GetTrackMedia (described on page 2-138 and page 2-190, respectively).

SPECIAL CONSIDERATIONS

Your application should not call the DisposeTrackMedia function as part of the process of disposing of a movie. When you dispose of a movie by calling DisposeMovie, the Movie Toolbox disposes of all the movie's tracks and their associated media structures.

ERROR CODES

invalidMedia

-2008

This media is corrupted or invalid